home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 3 / Light ROM 3 - Disc 2.iso / programs / pc / tddd2dos / readme2.txt < prev    next >
Text File  |  1994-02-21  |  12KB  |  249 lines
  1.  
  2. This is an lzh file containing a set of programs called T3DLIB (previously
  3. known as TTDDDLIB).  These programs convert 3D objects in the binary TDDD
  4. format into the Textual TDDD (TTDDD) format and back again, and also
  5. provide a number of other conversion filters.
  6.  
  7. -----------------------------------
  8.  
  9. These programs are provided as SHAREWARE. If you choose to use these programs,
  10. you are obligated to send in a $25 (US) to the author, Glenn Lewis.
  11. His address:
  12.  
  13.    Glenn M. Lewis
  14.    8341 Olive Hill Court
  15.    Fair Oaks, CA  95628
  16.    (USA)
  17.  
  18. Glenn is also reachable via email at glewis@pcocd2.intel.com.
  19.  
  20. ----------------
  21.  
  22. Enjoy these programs and the objects, and send in your Shareware fee to Glenn!
  23.  
  24. [condensed message from...]
  25. -Steve
  26.  
  27. --------------------------------------------------------------------------
  28. Steve Worley                                         Worley@cup.portal.com
  29. --------------------------------------------------------------------------
  30.  
  31.  
  32.     As of March 31, 1992, I have included the Amiga executables of the latest
  33. revision of T3DLIB in the files:
  34.  
  35.   T3DLIB*_68000exe.lha  (68000, non-FPU version)
  36.   T3DLIB*_68030exe.lha  (68030, FPU version)
  37.  
  38.     Note that these were compiled with SAS/C, and so they do not have that bogus
  39. restriction of running only under version 2.04 of the operating system like the
  40. R33 version of the executables had!
  41. Yahoo!  Thanks, Scott!
  42.  
  43.     You will find several filters in there, all of which support Imagine
  44. objects (and, of course, Turbo Silver objects).  The most important filter you
  45. will use is called "readwrite", which basically replaces the old ReadTDDD and
  46. WriteTDDD programs.
  47.  
  48.     "ReadWrite" will read from its standard input, *EITHER* an Imagine object
  49. file *OR* a TTDDD file, and it is smart enough to know which is which without
  50. you telling it.  (In fact, all of the executables from T3DLIB now read
  51. either type of file!)  It will also read old Turbo Silver files, and make all
  52. external objects internal.
  53.  
  54.     "readwrite" will, by default, output TTDDD files to its standard output.
  55. But if you give it the "-tddd" flag (or "-t" for short), it will output
  56. Imagine object files directly!
  57.  
  58.     Remember that all of these programs are filters, so you must redirect
  59. their input and output from/to files.
  60.  
  61.     readwrite   - reads and writes both TDDD and TTDDD files
  62.     tddd2mif    - reads TDDD or TTDDD files and outputs FrameMaker MIF files
  63.     tddd2ps     - reads TDDD or TTDDD files and outputs isometric wireframes
  64.                   with Top, Front, Right, and Isometric views in PostScript
  65.     tddd2nff    - reads TDDD or TTDDD files and outputs NFF files
  66.     tddd2off    - reads TDDD or TTDDD files and outputs OFF files
  67.     tddd2ray    - reads TDDD or TTDDD files and outputs Rayshade 4.0 files
  68.     tddd2vort   - reads TDDD or TTDDD files and outputs VORT files
  69.  
  70. Two new filters as of release 34 are:
  71.     tddd2dxf    - reads TDDD or TTDDD files and outputs DXF (AutoCAD) files
  72.     tddd2pov    - reads TDDD or TTDDD files and outputs POV-Ray 1.0 files
  73.  
  74. Here is some documentation on the OFF and NFF versions:
  75.  
  76. TDDD is a complex format that allows heirarchical structure to be
  77. defined. Thus, a car might be defined as different parts, such as the
  78. frame, the doors, the tires, and the windows. When you are converting
  79. from TDDD, sometimes you will want to merge all of the sub-parts together
  80. to form one single object, but other times it is convienient to have the
  81. different parts saved as seperate objects so you can manipulate them 
  82. easier. T3DLIB supports both conversion methods by a flag, -split. 
  83.  
  84. The programs included:
  85.  
  86. 1) tddd2off
  87.  
  88. Usage: tddd2off [-geom_only] [-split] [infile] [outfile]
  89.  
  90.    Converts an input TDDD or TTDDD file to an OFF format file. It defaults
  91.    to outputting both a .geom and a .ipcol file, but if you are only
  92.    interested in the structure of the object, the flag -geom_only
  93.    (or -g) will ouput only the point, edge, and face information.
  94.    -split will split heirarchical objects into individual objects.
  95.    In this case, if the outfile name is "model", the output names
  96.    would be "model001.geom", "model002,geom", etc. 
  97.  
  98. 2) tddd2nff
  99.  
  100. Usage: tddd2nff [infile] [outfile]
  101.  
  102.    Converts an input TDDD or TTDDD file and saves an NFF format file.
  103.  
  104. -------------------------------------------------------------------------
  105.  
  106.     Althought the following does not cut it for documentation (hopefully
  107. I will have some real docs by the next release...), I thought this might
  108. be helpful to some people:
  109.  
  110. >>>>> On Wed, 24 Jun 92 13:23:29 -0400, kelly@ll.mit.edu said:
  111.  
  112. Dave> Greetings;
  113.  
  114. Dave>         Can anyone out there tell me a little about the program
  115. Dave> TTDDD?  Specifically what kinds of things can be done with it
  116. Dave> (especially by none programmers such as myself). I downloaded some
  117. Dave> nice 3D fonts from hubcap that were converted from TeX with TTDDD.
  118. Dave> Is this the kind of thing that I could do with little or no
  119. Dave> programming? Also what other programs/excessories would be useful
  120. Dave> with TTDDD? Thanks for the help!
  121.  
  122.         Hi!  I am Glenn Lewis, the author of TTDDD and T3DLIB (previously
  123. known as "TTDDDLIB").  I thought I would post to the list so that
  124. everybody would be up-to-date.
  125.  
  126.         Basically, the old TTDDD programs, called "ReadTDDD" and
  127. "WriteTDDD" are obsolete, and do not support any of the new Imagine
  128. sub-chunks.  Let me give you a summary of what T3DLIB can do for you
  129. from my point of view, which is obviously quite biased.
  130.  
  131.         First, T3DLIB consists of two things: a linkable library of
  132. routines that allow programmers to manipulate 3D objects and scenes
  133. easily from within their own applications.  (Of course if you wish to
  134. use my code in a commercial product, you must check with me first, as
  135. one author failed to do.)  The second part of T3DLIB is a collection of
  136. filters that are built using the linkable library.  T3DLIB supports
  137. (reads/writes) most all "chunks" in the Imagine TDDD file format.
  138.  
  139.         The source code (and executables that run under *BOTH* 2.04 and 1.3
  140. of the Amiga operating system without any special libraries) are available on
  141. hubcap.clemson.edu [130.127.8.1] in the directory:
  142. pub/amiga/incoming/imagine/TTDDDLIB.
  143.  
  144.         The main program included in T3DLIB is called "ReadWrite".  This
  145. is the one that makes the previous two programs obsolete, as mentioned
  146. above.  "ReadWrite" is simply a filter, but a powerful one.  First off,
  147. I better describe what the TTDDD format is: TTDDD is "Textual TDDD", and
  148. "TDDD" is an IFF (Interchange File Format [?]) that has many "chunks"
  149. and "sub-chunks" that describe objects and scene for Imagine (and
  150. previously Turbo Silver).  "TDDD" was created by Impulse, Inc.  TTDDD
  151. was created by me, and allows any text file to describe in full detail,
  152. all that a TDDD file can describe, but is editable and can be
  153. algorithmically generated.
  154.  
  155.         Back to "ReadWrite"...  ReadWrite reads a file from its standard
  156. input, and writes a file to its standard output.  The input file can be
  157. *either* a TTDDD *or* a TDDD file, and the output, by default, is a
  158. TTDDD file.  If "ReadWrite" is given the "-tddd" (or "-t" for short)
  159. flag on its command line, it will write a TDDD file that is directly
  160. loadable by Imagine.  Since Imagine does not support "external" objects
  161. like Turbo Silver did, "ReadWrite" will load any "external" objects at
  162. that time and make them internal to make Imagine happy.  Also, if one
  163. wishes to "optimize" points and edges (by simply removing redundancies),
  164. the "-m" (for "merge") flag will accomplish this.  This does, however,
  165. take much longer processing time, so sit back and let it crunch on the
  166. object(s).
  167.  
  168.         This, obviously, is the most useful (and necessary) program for
  169. dealing with TTDDD and TDDD files.  Here is a list of other utilities
  170. that are included:
  171.  
  172. tddd2off tddd2nff tddd2vort tddd2ray tddd2ps tddd2mif tddd2dxf tddd2pov
  173.  
  174.         All of the above are also filters, and perform the following
  175. conversions:
  176.  
  177. tddd2off  - converts TDDD (or TTDDD automatically) to OFF format
  178. tddd2nff  - converts TDDD (or TTDDD automatically) to NFF format
  179. tddd2vort - converts TDDD (or TTDDD automatically) to VORT format
  180. tddd2ray  - converts TDDD (or TTDDD automatically) to Rayshade 4.0 format
  181. tddd2ps   - converts TDDD (or TTDDD automatically) to PostScript format
  182. tddd2mif  - converts TDDD (or TTDDD automatically) to MIF format
  183. tddd2dxf  - converts TDDD (or TTDDD automatically) to DXF (AutoCAD) format
  184. tddd2pov  - converts TDDD (or TTDDD automatically) to POV-Ray format
  185.  
  186. OFF is DEC's Object File Format.
  187. NFF is Eric Haines' (SP?) Neutral File Format.
  188. VORT is the "Very Ordinary Ray Tracer", I believe.
  189. Rayshade is that awesome program by Craig Kolb.
  190. PostScript output has 4 views: Top, front, right, and isometric.
  191. MIF is "Maker Interchange Format" for FrameMaker, and looks like the
  192.     PostScript output, but is editable from within FrameMaker.
  193. DXF is AutoCAD's interchange file format.
  194. POV is POV-Ray's file format.
  195.  
  196.         The entire T3DLIB package is shareware, and costs $25 to
  197. register.  Details are in the sources archive on hubcap.  As a "Thank You" 
  198. for registering, I will send you a disk with the two utilities: TSTeX
  199. (which created the font you viewed on hubcap from public domain TeX
  200. fonts [in PK format]) and SQuad, which generates superquadric surfaces
  201. based upon parameters that you supply it.  Examples of superquadrics are
  202. torii, cubes (with rounded edges), diamonds, and a sphere is a
  203. degenerate superquadric.  I will also send you a copy of the TDDD file
  204. format, which is basically the documentation for the TTDDD file format,
  205. as it uses the same names, but is editable.  I also provide some
  206. examples on the diskette.
  207.  
  208.         But back to your original question: What can this do for
  209. non-programmers?  Well, you will probably find the utilities useful, and
  210. you may be interested in looking at the geometric details of an object
  211. (OK, maybe not :-).
  212.  
  213.         Most definitely, though, the power of the package comes from
  214. being able to algorithmically generate or modify objects and scenes for
  215. animating or for simply creating/modifying complex objects.
  216.  
  217.         Helge Rasmussen, for example, created a program called
  218. "igensurf" that uses the TTDDD format and filters to generate basically
  219. any surface that you can describe mathematically in closed form.
  220.  
  221.         Steve Worley, for another example, created an animation of a
  222. waterfall by algorithmically controlling the positions of thousands of
  223. little spheres.
  224.  
  225.         I, for a third example, created the steam locomotive object on
  226. hubcap with the help of TTDDD, and animated the pistons and wheels.
  227.  
  228.         One of my registered shareware users has a cabinetry business
  229. and models all cabinets and drawers using TTDDD first, and presents a
  230. video of his plans to the customer before he ever starts, making each
  231. presentation expressly unique for that person's kitchen or room.
  232.  
  233.         Feel free, if you have any questions, to send me e-mail.  I hope
  234. I have answered any questions you have, without attempting to make this
  235. a commercial.
  236.  
  237.         Future work includes general object morphing for Imagine such
  238. that *any* two objects can be morphed from one to the other, with T3DLIB
  239. creating all the in-betweens, since Imagine currently can only morph two
  240. objects with the same topology (points/edges/faces).
  241.  
  242.         Of course, work on this will not continue until Steve Worley and
  243. I finish up Essence and ship it.  :-)  [Hmmm... as of release 34, that is
  244. not longer an excuse, so I will have to think of another good one.  :-) ]
  245.  
  246.                                                         -- Glenn
  247.  
  248. Glenn Lewis | glewis@pcocd2.intel.com | These are my opinions...not Intel's
  249.